MailBeamer for Microsoft Mail |
|
Contents |
|
Introduction |
Advanced Configuration |
Installation |
History and Licensing |
|
For outgoing SMTP messages MailBeamer scans the
SMTP queue on your postoffice and if a messages is found, MailBeamer converts it to MIME
or UUENCODE. MSMail addresses are converted to an SMTP address by first scanning the User Address table for a matching user. If a match is found, MailBeamer will use that address. If no match is found in User Address table, MailBeamer will scan the Postoffice Route table for a match of the network and postoffice. If a match is found, MailBeamer uses the domain from the Postoffice Route and the mailbox from MSMail to create the SMTP address. Then MailBeamer queries your names server for the mail server(s) of the target domain and send the message to this host. Note: If a relay host is given, then MailBeamer forwards the message to this host, which in turn does the actual job of sending the message to the recipient. For incoming messages MailBeamer is either listening on TCP/IP port 25 and if a mailer establishes a connection, MailBeamer creates a new thread for this connection, receives the message, converts the message from MIME or UUENCODE and puts it into the mailbag of the MSMail recipient. Or MailBeamer scan a POP3 mailbox , converts the messages from MIME or UUENCODE and puts it into the mailbag of the MSMail recipient. For an incoming message, MailBeamer has to find the MSMail mailbox of the recipient. If the incoming message is received via SMTP, MailBeamer first scans the SMTP Forwarding table for a match. If it finds one, the message is sent to this SMTP address. It there is no match or the message was received via POP3, the MailBeamer scans the User Address table. If it finds a match, it sends the message to this MSMail mailbox. At least MailBeamer extracts the domain part out of the recipients SMTP address and scans the Postoffice Route table for a match of the domain. If a match is found, MailBeamer queries the address list of the postoffice for a user that matches the user part of the recipients SMTP address. If there is a problem with a message that MailBeamer can not handle, the messages is optionally sent the person who is responsible for MailBeamer, so that no message is lost. However, you can also choose to return the message to the sender. |
If you have a leased line or a
direct connection to the Internet than you should receive messages using SMTP
which is fast and reliable. For a quick start please read |
If you have a Dial-Up connection
to the Internet you should receive messages using Inbound POP3 Routing which
requires nearly no changes at your ISP. MailBeamer will then act like a normal email
client to your ISP and your don't get struggled with the whole DNS / MX stuff. For a quick start please read
Note: If you want to receive all mail for your whole company through one POP3 mailbox, then select Auto Detect in Inbound POP3 Routing and ask your ISP to set up a star POP3 mailbox, which means that all messages to your domain name should be routed to one POP3 mailbox. |
Create a directory on your machine and copy all
the files into this directory. Start MBAdmin.exe to configure MailBeamer. On your first start you will prompted for the following information:
Depending if you want to use direct delivery or not you need to fill in the field for the name server and/or the relay host. The rule for the fields are as follows:
MailBeamer first try's to send directly and if this fails it forwards it to the relay host
MailBeamer try's to send directly and if this fails it will retry it as long as the message timeout expires
MailBeamer forwards all to the relay host If you have a leased line to the Internet you can leave all other settings at their defaults, but if you to use a Dial-Up connection to the Internet, switch to the Dial-Up tab and enable Dial-Up Network. Note: The Dial-Up Network schedule is only for SMTP connections, not for POP3 connections. After you closed the dialog by pressing Ok , MailBeamer verifies that there is a SMTP gateway installed on your postoffice. If no SMTP Gateway is found, MailBeamer will prompt you to
install the SMTP Gateway on your postoffice. Note: If you currently have a different SMTP Gateway installed which is completely compatible to the Microsoft Gateway, MailBeamer will use it's queue and will not install a new one, but it will not use it's configuration or postoffice address mapping. There after MailBeamer creates a default address mapping with your Network and postoffice and the domain "domain.com". You can change this to your real domain name by double clicking on the record in the main window. Now you are ready to start MBServer.exe and take a look at the screen to see if MailBeamer works and no error messages are displayed. Restart your Microsoft Mail Client and you will see a new address template called SMTP. Create a new message using this SMTP template and fill in the address with a valid Internet address like michael@dataenter.co.at MailBeamer should pick up the message and if everything is ok, the message will be sent. |
Receiving messages with SMTP |
MailBeamer will not receive SMTP messages from
the Internet until you create a Mail Exchange ( MX ) record in
your DNS ( Domain Name Server ) which points to the machine where MailBeamer is running
on. If you are unsure what a MX record is, you can either read More about MX Records below or ask your ISP to do it for you. To verify that your MX record is valid, type
at the Command Prompt, where domain.com should be replaced by your domain name. Note: An MX record shouldn't point to a CNAME, it will most probably cause you a lot of trouble!!! Note: You should add a reverse lookup for the IP address in your DNS which points to the machine where MailBeamer is running on, because some SMTP mailers refuse to send messages if the Reverse Lookup is not available or not correct. If you bind MailBeamer to second IP address, you need to add a reverse lookup for the IP addresses, because MailBeamer uses it to get it's own name. To verify that your Reverse Lookup is valid, type
where 111.111.111.111 should be replaced by the IP address of the machine where MailBeamer is running on. |
Important note if you have a Workgroup Postoffice |
If your postoffice is an Workgroup postoffice
rather than a MSMail 3.x postoffice, then your Admin program refuses to work after
MailBeamer is installed. The reason is, that
Microsoft has built in a check in the Admin program to prevent you from using a gateway
like MailBeamer in the free-of-charge version of MSMail and so Admin gives you an error
message when threre is one. View -> SMTP Gateway -> WFW postoffice only -> Enable WFW Admin and suspend SMTP Gateway from MailBeamer Admin menu prior to starting WFW Admin. View -> SMTP Gateway -> WFW postoffice only -> Disable WFW Admin and resume SMTP Gateway to resume the gateway. |
Address Mapping is one of the key features of
MailBeamer.
|
By default your Internet address will be your
MSMail mailbox plus the domain. Assume your mailbox is Bill and your domain is acme.com, then your Internet address is bill@acme.com You can override this in View -> User Address... by providing a complete SMTP address for a specific mailbox. Note: If you define more than one SMTP address for the same mailbox, only first is used for outgoing mail, but all are used for incoming mail. |
By default MailBeamer sends all messages which
require a encoding using MIME with codepage of Western European (ISO-8859-1) which is
today's standard. However there are old mail systems
on the Internet which can not handle MIME.
|
Outbound POP3 is the way a POP3
client can access the postoffice. By default Outbound POP3 access to your postoffice is disabled. To enable it, start MailBeamer Admin, select View -> Options -> Connections -> POP3 Transfer Mode -> Outbound Only To test the POP3 configuration start any POP3 client like Netscape Mail, Microsoft Windows Messaging, Microsoft Internet Mail, Outlook Express, Exchange Client with INet, Outlook with INet or Eudora and configure it to receive messages from MailBeamer. Usually your POP3 client want's to know the following:
Note: If your Microsoft Mail password is blank, but your POP3 Client wants to have one, type in any password. In general, it's a good idea to use passwords when POP3 is enabled, because without a password anyone on the Internet or Intranet can read your messages. Make sure you are closing your Microsoft Mail Client prior starting the POP3 Client, because when a messages arrives only one of the two will pick up the message. If your Microsoft Mail Client polls the postoffice faster than the POP3 Client, then the Microsoft Mail Client will get the message instead the POP3 Client.
|
Receiving messages with POP3 |
With Inbound POP3 enabled,
MailBeamer scans any POP3 mailbox and forwards the messages to your postoffice. To enable it, start MailBeamer Admin, select View -> Options -> Connections -> POP3 Transfer Mode -> Inbound Only For every POP3 mailbox that MailBeamer should scan, you
need to create a routing in MailBeamer needs to know the mailbox, the password and the
server ( host ) where the mailbox resides. Note: In the case MailBeamer can not find a valid recipient in the SMTP header it will forward the message to the admin. It will not generate and NDR message! By default MailBeamer scans POP3 mailbox every 15 minutes for new messages unless you change the schedule. |
Keep in mind that MailBeamer needs to reside on a
local disk or the Service Controller can't start. For the samples below, we assume MailBeamer is in C:\MailBeam. Be sure that MailBeamer is running well in Console Mode and there is no error, because once you run it as a Service, you can't see a screen and a problem will only be visible in the log file. There are two different install methods depending of the location of your postoffice.
You can start and stop MailBeamer at any time via Control Panel Note: After you started MailBeamer as a Service, verify that MailBeamer has no errors ( i.e. it have access to all your postoffices ). You need to take a look into the log file to do this. |
Start MBServer.exe one time with an
argument of remove, by typing
at the Command Prompt and MailBeamer will delete the service. |
|
You will find the latest version of MailBeamer at
http://www.dataenter.co.at/download.htm
To upgrade your current version of MailBeamer
|
MailBeamer has two modes for sending SMTP
messages: Sync Mode and Async Mode. In Sync Mode MailBeamer extracts one message out of the SMTP queue and sends it to the relay host. This cycle is repeated for every message until no more messages are available. In Async Mode MailBeamer extracts all messages out of the SMTP queue in one thread and a second thread sends these messages to the relay host. MailBeamer try's to minimize DNS queries and network traffic and sends all available messages using one session. As a result of Async Mode, you will not see messages in the SMTP queue when you are using MSMail's admin.exe. You can find unsent messages are in the MSG-OUT folder where every message is represented using a pair of files, one with a TXT extension and the other with a ONX extension. Note: When Dial-Up is enabled, MailBeamer always uses Sync Mode, because it's the most efficient way to send messages. |
The following information is intended for the DNS
administrator: The MX resource record provides the ability to publish mail routing information using DNS. This is useful for several reasons: MX records allow multiple hosts to accept mail on behalf of a single host. If the destination mail server is down or otherwise off-line, then one of the other mail servers can accept mail on that system's behalf. When the destination system is brought back on-line, the secondary mail servers will forward the mail to it. MX records allow multiple hosts to accept mail on behalf of a domain. Rather than address mail to user@host.domain.com,
you can simply send mail to user@domain.com. The format of the MX record differs slightly from the format of an A record. Rather than use IP addresses, the MX record uses host names instead. Also, an additional field provides an ability to set preferences for which hosts are the end-targets. For example, the following MX resource record indicates that all mail addressed to user@domain.com should be sent to MailBeamerMachine, and then to AnotherHost if MailBeamerMachine is unreachable: domain.com IN MX 10 MailBeamerMachine IN MX 20 AnotherHost Note: Under no circumstances should you
use MX records in conjunction with CNAME alias records. |
MailBeamer does the virus scanning by calling an
external virus scanner. Currently there are two scanners known to work with MailBeamer, which are
Note: Do not use the unregistered version
of DrSolomon FindVirus, because this version will pop up a dialog box and waits for a user
input. MailBeamer will then wait until you press the ok button. Note: When you select the exe file for the scanner, make sure you are using an UNC name if your scanner is not on a local harddisk. Note: You need a proper license for your virus scanner. Please read carefully the license agreement of your scanner. MailBeamer does not include a license for the scanner! Some language specific versions of the license agreement of DrSolomon do not allow that FindVirus can be started by another program. Make sure you license agreement allows this. Beside of the supported scanners you can use nearly every scanner that can be started from a Command line. MailBeamer calls the scanner with the arguments you specified and the current file name. As an example here are the input you need to make for McAfee NTScan:
MailBeamer translates <FILE> to the current filename and then starts the scanner. This would look like:
You need to make sure that your scanner scans all files for all viruses, because MailBeamer passes over a filename with no extension and scanners which do their virus scanning based on a files extension, will fail. On return of the scanner, MailBeamer checks the errorlevel. If the errorlevel is anything except 0 ( NULL ) it will consider the file as infected by a virus. |
MailBeamer can handle zero, one or more downstream
postoffices. However you will need to install SMTPVia, which is a add-on to MailBeamer, on the downstream postoffice(s). To make it more clear, the main postoffice is the postoffice
where MailBeamer is running on. All other postoffices are so called downstream
postoffices. To let the users on the downstream postoffice send and
receive SMTP messages, you need to add every downstream postoffice into
MailBeamer's configuration. Then you need to apply SMTPVia against every downstream
postoffice. Start SMTPVia and fill out the Path to postoffice which would be \\REMOTE\MAILDATA and the Network and Postoffice which is the Network and Postoffice of the main postoffice ( the one MailBeamer is running on ). Note: In the case that your downstream postoffice are not directly routed to the main postoffice you need to specify the Network and Postoffice of the next hop. Once you have done this its a good idea to restart External.exe or it will take one hour until External.exe recognizes the changes in the configuration. Thereafter your users on the downstream postoffice should be able to send and receive messages. Note: SMTPVia is licensed per postoffice and you will need one license for every downstream postoffice. Note: There is no demo version of SMTPVia
and you can order SMTPVia only when ordering together with MailBeamer.
|
In SMTP it's usual that a mailbox called POSTMASTER
exist and that someone can send to this mailbox. MailBeamer forwards such a message to the mailbox you selected as the admin for a postoffice. Do not create a mailbox called POSTMASTER ,because POSTMASTER is handled different than a normal mailbox. MailBeamer restarts itself every 7 days to clear all it's internal caches. If you run MailBeamer on a Win95 machine, then it's a good
idea to install Service Pack 1. If you run MailBeamer under Win95 and get the error
"No machine name given" at startup, then start |
|
MailBeamer © is copyrighted 1993-1999 by
DataEnter, Michael Kocum, portions © Microsoft Corp. This product and it's documentation may not, in whole or in part, be copied, reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other natural or computer language, in any form or by any means whatsoever, be it electronic, mechanical, magnetic, optical, manual or otherwise, without the prior written consent of DataEnter. DataEnter makes no warranty or representation, either expressed or implied, with respect to the product MailBeamer and it's documentation, their quality, performance, merchantability, or fitness for a particular purpose. DataEnter reserves the right to revise the user's guide and make changes in the content without obligation to notify any person or organization of such a change. In no event will DataEnter be liable for any direct, indirect, special, incidental or consequential damages, real or imagined, resulting from the use or purchase of this software. Under no circumstances shall DataEnter's liability for damages exceed the price paid for the software license. Should any remedy hereunder be determined to have failed, all limitations of liability and exclusion of damages set forth above shall remain in full force and effect. The extent of the DataEnter's warranty for the software and it's documentation is limited to physical defects of the distribution media containing the software. Contact DataEnter to obtain return authorization for the replacement diskette within 30 days of the original date of purchase. Any further statement made by agents, employees, distributors or dealers of DataEnter do not constitute warranties and are not binding. No employee of DataEnter has the authority to modify any portion of this warranty. All brand and product names we refer to in the documentation are used solely for identification purposes and may be trademarks of other companies. DataEnter, (the licensor) grants the buyer (the licensee) the right to use this copy of MailBeamer (the program) on a single computer at a single location servicing a single postoffice as long as the licensee complies with the terms of this license. The licensor reserves the right to terminate this license if the licensee violates any part of the agreement. The licensee agrees to make copies of the program only for backup purposes. The licensee agrees not to copy the documentation and to take all necessary precautions to ensure that the backup copies of the software are not distributed to or acquired by other parties. Microsoft Mail is a trademark of Microsoft Corp. |
v3.00 97-05-28
v3.01 97-06-16
v3.03 97-07-04
v3.04 97-07-09
v3.05 97-07-31
v3.07 97-08-30
v3.08 97-09-19
v3.09 97-10-17
v3.10 97-11-01
v3.11 97-11-08
v3.12 97-12-10
v3.13 98-01-22
v3.14 98-02-28
v3.15 98-04-11
v3.16 98-05-18
v3.17 98-07-07
v3.18 98-09-03
v3.19 98-10-24
v3.20 98-12-01
v3.21 99-01-30
|
Changed: 1999-03-22 12:05 |
Copyright © 1996-1999 DataEnter, Michael Kocum |